home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / 1wp2fax.lzh / 1WP2FAX / 1WP2FAX.ENG < prev    next >
Text File  |  1993-02-25  |  8KB  |  200 lines
  1. 1WP2FAX: 1st Wordplus-to-Fax Converter       (c) Jan Willamowius, 1992
  2. --------------------------------------
  3.  
  4. 1WP2FAX is shareware up to version 1.5. It may be copied freely but
  5. distribution together with commercial software or via commercially
  6. operated online-services requires prior written permission by the
  7. author. If you continue to use 1WP2FAX after an initial trial period
  8. you have to send DM 20,- to the author. (see below)
  9. In return you'll receive the most up-to-date version. (Don't forget to
  10. tell me your [email] address!)
  11. Versions 1.6 and up are reserved for registered user and may not be
  12. distributed.
  13.  
  14.  
  15. What does 1WP2FAX ?
  16. -------------------
  17.  
  18. Since no fax program available can send the most popular text format
  19. properly, I wrote my own driver. The 1st Wordplus document is converted
  20. into an IMG graphic that shows the text with all attributes. The graphic
  21. is exactly in fax resolution, so it can be sent with all available fax
  22. programs (e.g. ST-Fax, QFax, Junior/TeleOffice or STraight Fax!).
  23.  
  24.  
  25. 1WP2FAX has an integrated font that looks quite good in low resolution
  26. as well as in high resolution. The IMG is always in high resolution,
  27. but the fax software can easily convert it to low res since every 2 pixel
  28. lines are the same.
  29.  
  30. The fax doesn't look better in high res, so if there are no other images
  31. that require high res, just use low res and save some time.
  32.  
  33. The following 1st Wordplus text attributes are supported:
  34. - bold
  35. - underlined
  36. - light
  37. - italics
  38. - superscript
  39. - subscript
  40.  
  41. The settings for page length and margins are observed to have the
  42. page breaks where 1st Wordplus would have them. One graphic image is
  43. produced for every page in the document.
  44.  
  45. No line may contain more than 107 characters including margins; more
  46. characters are ignored. The default left margin is 12 characters, but
  47. it can be changed with the -R Option.
  48.  
  49.  
  50. Using 1WP2FAX:
  51. --------------
  52.  
  53. 1WP2FAX.TTP is given a commandline with one or more filenames of
  54. 1st Wordplus or ASCII documents. It creates a file named WPFAX_n.IMG
  55. in the current folder for every page in the document. (n being the
  56. page number)
  57.  
  58.  
  59. Using different fonts: (REGISTERED VERSION ONLY)
  60. ----------------------
  61.  
  62. When you write a text with 1st Wordplus, it is displayed with the ST's
  63. built-in font. What the font in the printed version looks like depends
  64. on the font that is built into your printer. You can use a printer with
  65. a different font to make it look differently. With 1WP2FAX you can change
  66. the file 1WP2FAX.DAT to get a different font.
  67. The folder FONTS contains some fonts that you can copy over the 1WP2FAX.DAT
  68. that's in place right now. For every font there is a IMG file with a
  69. text sample so you can see which font suits your needs.
  70.  
  71. The fonts ANTIQUA.DAT and EGYPTIEN.DAT were created by Wolfram Roisch,
  72. Daertorfer Weg 8B, 2104 Hamburg 94, Germany. The others were provided by
  73. Hayo Schmidt, Grotiusweg 1, 2000 Hamburg 55, Germany.
  74.  
  75. The folder FAXFONT and GDOS2FAX (also by Hayo Schmidt) each contain a
  76. converter to create your own fonts either from scratch or from GDOS fonts.
  77.  
  78.  
  79. Limitations of the current version:
  80. -----------------------------------
  81.  
  82. Always non-proportional Pica is used with a line spacing of 1.
  83.  
  84. Footnotes are being ignored in this version.
  85.  
  86.  
  87. The future:
  88. -----------
  89.  
  90. Does anyone need footnotes in a fax document ?
  91.  
  92.  
  93. A fax driver for WordPerfect is under development. If you are interested,
  94. please contact me for further details.
  95.  
  96. Please send me your bug reports and tell me how the program can be
  97. improved. If you have any inside information on the format of 1st Wordplus
  98. documents please let me know.
  99.  
  100. Author:
  101.  
  102. Jan Willamowius                 Bank: Hamburger Sparkasse (BLZ 200 505 50)
  103. Nienredder 6                    Account: 1050751245
  104. 2000 Hamburg 54
  105. Germany                         Please make all checks etc. payable in
  106.                                 German Marks! When sending dollars add
  107. E-Mail: jan@janhh.hanse.de      $10 to cover bank charges.
  108.  
  109.  
  110.  
  111.  
  112. Updates:
  113. --------
  114.  
  115. Version 1.0     initial release
  116.  
  117. Version 1.1     more special characters
  118.  
  119. Version 1.2     font completed; bugfixes
  120.  
  121. Version 1.3     page header and footer supported; feedback what files are
  122.                 being written
  123.  
  124. Version 1.4     On startup all WPFAX_*.BAK files are deleted and all
  125.                 WPFAX_*.IMG files are renamed to WPFAX_*.BAK.
  126.  
  127. Version 1.5     The numbers for footnotes are included in the fax; the
  128.                 footnotes themselves are still being ignored. Conditional
  129.                 page breaks are done correctly now.
  130.  
  131. Version 1.6     Pictures in the document appear now in the fax; there is a
  132.                 maximum of 10 _overlapping_ pictures.
  133.                 2 new commandline options:
  134.                 -Q   no screen output (for use by GEM shells)
  135.                 -Rn  set left margin to n characters
  136.                      (no space between R and the number!)
  137.  
  138. Version 1.7     Documents created with 1st Wordplus versions prior to 3.15
  139.                 are now handled correctly.
  140.                 The following strings are replaced in the document:
  141.                 (as in ST-FAX II with LANGUAGE GERMAN or in TeleOffice)
  142.                 %SEITE / %PAGE
  143.                 %TAG / %DAY
  144.                 %TAGNAME / %DAYNAME
  145.                 %MONAT / %MONTH
  146.                 %MONATSNAME / %MONTHNAME
  147.                 %JAHR / %YEAR
  148.                 %ZEIT / %TIME
  149.                 %FORMFEED
  150.                 Even the undocumented symbols (& and $) in headings are
  151.                 supported.
  152.                 fixed reading of pictures
  153.  
  154. Version 1.8     The default font is now part of the program and doesn't
  155.                 need to be loaded. You can still use other fonts by placing
  156.                 them as 1WP2FAX.DAT in the current folder.
  157.                 Page numbers set by 1st Mail are recognised.
  158.  
  159. Version 1.9     Bugfix concerning headers and footers. The error message
  160.                 about too long lines is only displayed once per line.
  161.  
  162. Version 1.91    Bugfix for including pictures that overlap a text line.
  163.                 Also fixed are headers/footers, that contain a date
  164.                 _and_ a page number.
  165.  
  166. Version 1.92    optimized to run about 30% faster
  167.  
  168. Version 1.93    only internal changes
  169.  
  170. Version 1.94    New keyword: %FONT path
  171.                 A blank Line is created (in order to have the same page
  172.                 breaks) and the named font is loaded.
  173.                 Bugfix for %FORMFEED
  174.  
  175. Version 1.95    Support add for condensed and double-size printing.
  176.                 New option:
  177.                 -Z      2-digit page number in name of output file
  178.  
  179. Version 1.96    bugfix in output of %TIME
  180.                 The position of an underline depends now on the position of
  181.                 the underline character in the currently active font.
  182.                 A printer driver for Wordplus is included, so the size of
  183.                 IMG-graphics is the same as in the created fax.
  184.  
  185. Version 1.97    bugfix for read-only IMG-graphic files
  186.                 1WP2FAX now returns error codes when terminating
  187.                 UNDO terminates the conversion process after a page is
  188.                 written.
  189.                 New option.
  190.                 -A    abort conversion on first error
  191.  
  192. Version 1.98    bug removed that sometimes swallowed the last line in a
  193.                 document
  194.  
  195. Version 1.99    Generation of small and wide characters completely rewritten.
  196.                 Now you can have up to 150 small characters per line
  197.                 (1st Wordplus doesn't allow for more) or up to 53 wide
  198.                 characters.
  199.  
  200.